'use strict'

/**
 * Expose compositor.
 */

module.exports = compose

/**
 * Compose `middleware` returning
 * a fully valid middleware comprised
 * of all those which are passed.
 *
 * @param {Array} middleware
 * @return {Function}
 * @api public
 */
// 接受一个数组，返回一个函数
function compose (middleware) {
  // 如果中间件不是一个数组，则报错
  if (!Array.isArray(middleware)) throw new TypeError('Middleware stack must be an array!')
  // 检测中间件里面是否每一个中间件都是函数类型，不是则报错
  for (const fn of middleware) {
    if (typeof fn !== 'function') throw new TypeError('Middleware must be composed of functions!')
  }

  /**
   * @param {Object} context
   * @return {Promise}
   * @api public
   */
  // 返回一个函数，接受context, 和 next 参数
  return function (context, next) {
    // last called middleware #
    // 
    let index = -1
    // 
    return dispatch(0)
    // 执行第几个中间件
    function dispatch (i) {
      // 每执行一次next函数， 则调用一次dispatch, 如果一个有多个next 函数，则会多执行
      // 一次dispatch
      if (i <= index) return Promise.reject(new Error('next() called multiple times'))
      // 逐步递增，随着中间件的执行增加
      index = i
      // 查找第i 个中间件
      let fn = middleware[i]
      // 如果i 和 中间件个数相等，表示执行的不在是中间件中的函数，比如路由处理程序
      if (i === middleware.length) fn = next
    
      if (!fn) return Promise.resolve()
      // 防止中间件函数有错误产生，使用try catch 捕捉错误
      try {
        //执行中间件函数,返回Promise 类型
        // 当执行函数到next() 时，则先执行下一个中间件
        return Promise.resolve(fn(context, dispatch.bind(null, i + 1)));
      } catch (err) {
        // 执行中间件差生错误，返回错误
        return Promise.reject(err)
      }
    }
  }
}
